package com.feisuanyz.service;

import com.feisuanyz.pojo.dto.UserDTO;
import com.feisuanyz.pojo.dto.UserLoginDTO;
import com.feisuanyz.pojo.query.UserQuery;
import com.feisuanyz.pojo.vo.UserVO;
import java.lang.Boolean;
import java.lang.String;

/**
 * 用户管理
 *
 * @author Chenke Zhao
 * @date 2025-03-06 10:18:05
 */
public interface UserService {

    /**
     * 用户注册: 校验入参的合法性，检查用户名和邮箱是否已存在，生成密码哈希，插入用户信息到users表
     *
     * @param userDTO 用户注册信息
     * @return
     */
    Boolean registerUser(UserDTO userDTO);

    /**
     * 用户登录: 校验入参的合法性，检查用户名是否存在，校验密码哈希是否匹配，生成JWT token
     *
     * @param userLoginDTO 用户登录信息
     * @return
     */
    String loginUser(UserLoginDTO userLoginDTO);

    /**
     * 身份验证: 校验入参的合法性，验证JWT token的有效性，查询用户信息
     *
     * @param userQuery 用户查询信息
     * @return  用户视图信息
     */
    UserVO validateUser(UserQuery userQuery);
}
